home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / cisbl111.zip / CISBILL.DOC < prev    next >
Text File  |  1993-01-07  |  15KB  |  373 lines
  1.                              CISBILL  1.11              Rev. Jan '93
  2.                        <c> 1991,1992, 1993 JN Goodale
  3.  
  4.               
  5.               
  6.                        D O C U M E N T A T I O N              
  7.               
  8.               
  9.               
  10.                            _______
  11.                       ____|__     |                (R)
  12.                    --|       |    |-------------------
  13.                      |   ____|__  |  Association of
  14.                      |  |       |_|  Shareware
  15.                      |__|   o   |    Professionals
  16.                    -----|   |   |---------------------
  17.                         |___|___|    MEMBER
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                  
  27.                                  CONTENTS                 Page
  28.  
  29.                  I     Requirements and Limitations .......  1 
  30.                 II     Main Menu ..........................  1 
  31.                III     Set Up .............................  2 
  32.                 IV     Field Definitions ..................  2
  33.                  V     Function Keys ......................  3
  34.                 VI     Files ..............................  3
  35.                VII     Error Messages .....................  3
  36.               VIII     Capturing a Billing File ...........  4
  37.                 IX     Sharware Concept/Ombudsman .........  7
  38.  
  39.                                                       CISBILL 1.11   Page  1
  40.  
  41.      I  REQUIREMENTS AND LIMITATIONS
  42.  
  43.      Requires: IBM compatible               If you are using this, you
  44.                256 K memory                  probably have a modem.
  45.                Hard Drive                    However, a modem is NOT
  46.                DOS 3.0 or above              needed to run CISBILL, because
  47.                Printer - optional            it does NOT get the billing
  48.                                              from CIS for you.
  49.  
  50.                BILLING.CAP, a captured file from a CIS billing inquiry. 
  51.                For a sample of what this is, and instructions on how to 
  52.                get it, see the section on CAPTURING A BILLING FILE.
  53.  
  54.      Limits:   Will handle up to approximately 2200 records in 256 K -
  55.                7500 in 640 K, depending on your system.  One record is 
  56.                one logon session.  2200 records would amount to about 
  57.                6 sessions per day, 365 days per year.
  58.  
  59.  
  60.      II  MAIN MENU
  61.  
  62.          After processing existing files (if any) the Main Menu will appear:
  63.          ___________________________________________________________________
  64.  
  65.              This Year          Last Year           Special
  66.  
  67.              View Weekly        View Weekly          ....Quit....
  68.              Print Weekly       Print Weekly             Help
  69.              View Detail        View Detail             Set Up
  70.              Print Detail       Print Detail          REGISTER!!
  71.  
  72.         ____________________________________________________________________
  73.  
  74.         Select one of the options using the arrow keys.  If no previous year
  75.         file exists, that column of options will be presented as "..........".
  76.  
  77.         [ Help ] displays a quick description of the fields.
  78.  
  79.         [ Set Up ] is described in the next section, SET UP.
  80.  
  81.         [ REGISTER ] allows you to fill in the program registration from 
  82.         within the program.
  83.  
  84.                                                       CISBILL 1.11   Page  2
  85.  
  86.      III  SET UP
  87.  
  88.         [      Done      ] - exits Set-Up
  89.         [ Last Date Paid ] - change last date paid
  90.         [ Mono/Color     ] - toggles between color and mono display
  91.         [ Printer/File   ] - toggles between output to printer or file
  92.  
  93.      [ DONE ] will activate changes, if any, and return to the Main Menu.
  94.  
  95.      [ LAST DATE PAID ] displays the last date a payment was made to CIS,
  96.         in YYYYMMDD format.  You must input this, obviously.  It would
  97.         be the last date a charge was made to your bank, your credit card,
  98.         or whatever.  It is initialized at "19900101" which is Jan 1, 1990.
  99.         The purpose of this is to be able to check (√) the end of week
  100.         totals which have been paid, giving you a quick take on your 
  101.         outstanding liability, which is then printed at the end of the
  102.         listing or display.
  103.  
  104.      [ MONO/COLOR ] simply toggles the display between color and mono.
  105.  
  106.      [ PRINTER/FILE ] lets you elect to have all printout go to the file
  107.         CISBILL.PRN ready for printing, rather than a printer.
  108.  
  109.  
  110.      IV  FIELD DEFINITIONS
  111.  
  112.      [ Date ]:       MM DD of year printed in heading. (See Note 1)
  113.      [ Logon ]:      HH:MM Hours, Minutes of Logon time.
  114.      [ Session ]:    $ Cost of that session (Detail only).
  115.          or
  116.      [ Monthly ]:    $ Cost for the month (Weekly only).
  117.      [ Weekly ]:     $ Cost for that W/E - Week Ending.  The [ Session ]
  118.                      field may contain a value which is the sum of all
  119.                      charges not otherwise recorded - such as monthly fees,
  120.                      orders from CIS, etc..  This is sort of a "catch all"
  121.                      because I am only a dumb computer, and don't know
  122.                      all the miscellaneous charges CIS might make!
  123.  
  124.      [ √ ]:          This field will be checked if the item has been paid.
  125.  
  126.         The YEARLY TOTAL and CURRENT LIABILITY are printed at the end 
  127.         of the display or listing. 
  128.  
  129.      Note 1:  At year-end, the first weekly billing may contain data from
  130.                 the last few days of December of the previous year.  To
  131.                 keep these "wrong year" days in the right slot, they are
  132.                 assigned the new year, with a month of "00" rather than
  133.                 "12".
  134.  
  135.  
  136.                                                       CISBILL 1.11  Page  3
  137.  
  138.      V  FUNCTION KEYS
  139.  
  140.      Only two function keys are used with CISBILL:
  141.  
  142.         F1 - [Help]          Will display a quick description of the fields.
  143.         F3 - [Jump to Date]  Available only during "View Detail", will
  144.                              allow you to jump ahead to Month-Day MMDD.  You
  145.                              will be prompted for the Month-Day to jump to.
  146.  
  147.  
  148.      VI  FILES   
  149.   
  150.         Files needed to run CISBILL:
  151.                 CISBILL.COM - executable program
  152.                 BILLING.CAP - captured billing file (You create this)
  153.                               Once this has been read by CISBILL it can 
  154.                               be deleted.
  155.         Files created during CISBILL:
  156.                 CISBILL.CNF - Configuration file from Set Up
  157.                 CISBILL.Ynn - Cumulative Billing for year "nn"
  158.                               When the program detects a new year,
  159.                               a new Cumulative file is created.
  160.  
  161.  
  162.         Files included for sample run only:
  163.                 CISBILL.Y92 - Sample cumulative billing file for 1992.
  164.                 CISBILL.Y91 - Sample cumulative billing file for 1991.
  165.  
  166.                 Delete these files BEFORE starting your own cumulative
  167.                 billing files !!
  168.  
  169.  
  170.      VII  ERROR MESSAGES
  171.  
  172.      Error messages have the following format:
  173.  
  174.         [Program loc n] Dos error: xxxx....
  175.         Where:  n will be 1 thru 4
  176.                 xxxx.... will be a short DOS Error description
  177.  
  178.         if n = 1  The error occurred reading CISBILL.CNF
  179.                2  The error occurred reading CISBILL.Ynn
  180.                3  The error occurred writing CISBILL.CNF
  181.                4  The error occurred writing CISBILL.Ynn
  182.  
  183.      After displaying the error message, the program ends.
  184.  
  185.      If you get one of the errors and cannot determine what to do, contact
  186.      me (see page 6) with the following informations:
  187.  
  188.                 Complete error message
  189.                 File names and sizes of CISBILL.CNF, CISBILL.Ynn (all)
  190.                         and BILLING.CAP
  191.  
  192.  
  193.                                                       CISBILL 1.11   Page  4
  194.  
  195.      VIII  CAPTURING A BILLING FILE   
  196.    
  197.      After logging on to CompuServe, GO BILL
  198.         The remainder of this shows the CompuServe responses and your input.
  199.  
  200.         ASSISTANCE               BILLING
  201.  
  202.         BILLING INFORMATION
  203.  
  204.          1 Current Rates
  205.          2 Review Your Charges
  206.          3 Electronic Funds Transfer (EFT)
  207.             (U.S. Addresses Only)
  208.          4 Billing Options Explained
  209.          5 Pricing Plans Explained
  210.          6 Changing Your Billing Address
  211.          7 Update Billing Information
  212.          8 Executive Service Option
  213.          9 General Billing Information
  214.  
  215.        !2 <----------------------------------------Select option 2 here
  216.  
  217.  
  218.         ASSISTANCE               CHARGES
  219.  
  220.  
  221.         CompuServe CHARGES
  222.          1 Explanation
  223.          2 Account Balance
  224.          3 Billing History
  225.  
  226.         USAGE DETAILS
  227.          4 Current activity
  228.          5 Previous activity
  229.          6 Mail Hardcopy ($)
  230.  
  231.         Enter Choice !5 <-----------------------------Select option 5 here
  232.                         <--------Just prior to responding, open a capture
  233.                                  file, BILLING.CAP, to record the rest of
  234.                                  the billing session.
  235.  
  236.  
  237.                                                       CISBILL 1.11   Page  5
  238.  
  239.         CompuServe CHARGES                    (New CIS format 9-92)
  240.  
  241.             Week Ending       Total
  242.             -----------       -----
  243.          1    04-Apr-92       $3.63
  244.          2    29-Mar-92      $64.27
  245.          3    21-Mar-92      $18.35
  246.          4    14-Mar-92       $7.24
  247.          5    07-Mar-92      $42.95
  248.          6    29-Feb-92      $29.46
  249.          7    22-Feb-92      $64.21
  250.          8    15-Feb-92       $5.76
  251.          9    08-Feb-92        $.21
  252.         10    01-Feb-92      -$5.83
  253.         11    25-Jan-92      $58.74
  254.         12    18-Jan-92      $34.66
  255.  
  256.         Enter choice !1 <-------------------------Enter week # choice here
  257.  
  258.         CompuServe CHARGES
  259.  
  260.                    BILLING DETAIL (Page 1 of 1)
  261.  
  262.         Date  Description           Node   Logon Min Amount
  263.        ------ --------------------- ------ ----- --- ------
  264.        04-Apr BASIC SERVICES        06ATO  11:35   2    .00
  265.               TOTAL FOR SESSION                         .00
  266.  
  267.        03-Apr BASIC SERVICES        14AGF  17:32   3    .00
  268.               EXTENDED SVC-2400                    2    .43
  269.               TOTAL FOR SESSION                         .43
  270.  
  271.        01-Apr BASIC SERVICES        07ATO  15:25   3    .00
  272.               EXTENDED SVC-2400                    8   1.71
  273.               TOTAL FOR SESSION                        1.71
  274.  
  275.               BASIC SERVICES        01ATA  16:54   1    .00
  276.               TOTAL FOR SESSION                         .00
  277.  
  278.         Last Page ! <---------------------------------Hit [ENTER] here
  279.  
  280.                                                       CISBILL 1.11   Page  6
  281.  
  282.         CompuServe CHARGES
  283.  
  284.             Week Ending       Total
  285.             -----------       -----
  286.          1    04-Apr-92       $3.63
  287.          2    28-Mar-92      $64.27
  288.          3    21-Mar-92      $18.35
  289.          4    14-Mar-92       $7.24
  290.          5    07-Mar-92      $42.95
  291.          6    29-Feb-92      $29.46
  292.          7    22-Feb-92      $64.21
  293.          8    15-Feb-92       $5.76
  294.          9    08-Feb-92        $.21
  295.         10    01-Feb-92      -$5.83
  296.         11    25-Jan-92      $58.74
  297.         12    18-Jan-92      $34.66
  298.  
  299.         Enter choice !2 <----------------------Enter another week here
  300.  
  301.   ____________________________________________________________________         
  302.    
  303.      Continue the above process until you have accessed all weeks you   
  304.      have not yet captured.  The first time, you should get ALL weeks.
  305.      When you are finished, close the capture file.
  306.  
  307.      Move the capture file to the directory where you plan to keep   
  308.      your cumulative billing files, and you are ready to run CISBILL.
  309.  
  310.         >> Revised Sep '92 to handle the new CIS billing format.
  311.            Also will work in 43 or 50 line mode (if you are already
  312.              in that mode).
  313.         >> Revised Jan '93 to solve problem of some erroneous files
  314.              created during start-up.
  315.  
  316.  
  317.  
  318.  
  319.  
  320.     ____________________________________________________________________
  321.    |                                                                    |
  322.    |    If you have problems or questions, contact the author:          |
  323.    |                       JN Goodale                                   |
  324.    |                       7826 Little John Court                       |
  325.    |                       Charlotte,  NC  28227                        |
  326.    |                                                                    |
  327.    |                       CIS ID 71116,302                             |
  328.    |                       Phone   (704)-537-0329 (Your nickel!)        |
  329.    |____________________________________________________________________|
  330.  
  331.    Version 1.1     Sep 1992
  332.  
  333.                                                        CISBILL 1.1   Page  7
  334.  
  335.      IX SHAREWARE CONCEPT & OBUDSMAN STATEMENT
  336.  
  337.  
  338.         SHAREWARE CONCEPT
  339.         -----------------
  340.  
  341.         Shareware distribution gives users a chance to try software
  342.         before buying it.  If you try a Shareware program and continue
  343.         using it, you are expected to register.
  344.  
  345.         Shareware is a distribution method, not a type of software.  You
  346.         should find software that suits your needs and pocketbook, whether
  347.         it's commercial or Shareware.  The Shareware system makes fitting
  348.         your needs easier, because you can try before you buy.  And because
  349.         the overhead is low, prices are low also.  Shareware has the
  350.         ultimate money-back guarantee -- if you don't use the product,
  351.         you don't pay for it!
  352.  
  353.         OMBUDSMAN
  354.         ---------
  355.  
  356.  
  357.                Association Of Shareware Professionals Ombudsman
  358.  
  359.         This program is produced by a member of the Association of
  360.         Shareware Professionals (ASP).  ASP wants to make sure that the
  361.         shareware principle works for you.  If you are unable to resolve a
  362.         shareware-related problem with an ASP member by contacting the
  363.         member directly, ASP may be able to help.  The ASP Ombudsman can
  364.         help you resolve a dispute or problem with an ASP member, but does
  365.         not provide technical support for members' products.  Please write
  366.         to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send
  367.         a Compuserve message via easyplex to ASP Ombudsman 70007,3536
  368.  
  369.  
  370.                          .... End of CISBILL.DOC ....
  371.  
  372.  
  373.